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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 



This Technical Specification (TS) has been produced by ECMA on behalf of its members and those of the European 
Telecommunications Standards Institute (ETSI). 



Brief history 



The present document defines Ecma Application Session Services - a set of XML-based services used to establish and 
maintain an application session for exchanging application messages. 

The application session established by the present document is independent of the underlying transport protocol (TCP, 
HTTP, etc.) for exchanging application messages. 

Sessions for application protocols such as CSTA-XML (ECMA-323) may be established using the present document. 
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Scope 



The services defined in the present document are used to establish and maintain a relationship between an application 
and a server for the purpose of exchanging application messages. For the purpose of the present document this 
relationship is called an application session. 

Application protocols, such as ECMA-323, require that an application session is established before application 
messages are exchanged. ECMA-269 specifies several mechanisms for establishing an application context. One 
possible mechanism is ACSE (ISO/IEC 8649) - but since ASCE uses ASN. 1 encoding for its services, it is not desirable 
for use with XML based protocols such as ECMA-323. 

The present document provides an XML-based alternative for establishing application sessions. 

1.1 Overview 

The ECMA Application Session Services consist of the following services: 

• Start Application Session. This service is used by an application to establish an application session with a 
server. A globally unique sessionID is returned by the server in the response message. The sessionID is used in 
other services to address the session as long as the session exists. 

• Stop Application Session. This service is used by an application to stop an application session. 

• Reset Application Session Timer. This service is used by an application to reset the timer associated with an 
application session. If the application timer is not reset before it expirers, the application session will be 
terminated. 

• Application Session Terminated - This service is used by the server to indicate that the application session has 
been abnormally terminated (i.e. not via the Stop Application Session service). 

1 .2 Template description 

The services specified in clause 4 include tables that contain the following columns: 

Parameter Name: The name that is used to reference the parameter. This corresponds to the XML element name 
specified in clause 5. 

Type: The format of the parameter. This corresponds to the XML element type used in the XML 

schema definition in clause 5. 

M/O: The Mandatory/Optional aspect of the parameter. Mandatory parameters must be included in 

the corresponding XML instance document while optional parameters may be omitted. 

Description: Describes the purpose of the parameter. 
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2 Conformance 

This clause specifies the conformance requirements for an application and a server to conform to the present document. 

2.1 Application conformance 

In order to conform to the present document an application shall support the following services as follows: 

• Sending the Start Application Session service and all of the mandatory aspects of this service as specified in 
clause 4. 

• Sending the Stop Application Session service and all of the mandatory aspects of this service as specified in 
clause 4. 

• Sending the Reset Application Session service and all of the mandatory aspects of this service as specified in 
clause 4. 

• Receiving the Application Session Terminated service and all of the mandatory aspects of this service as 
specified in clause 4. 

• Send and receive XML Instance documents according to the XML Schema specified in clause 5 in the present 
document for the services listed in item 1 . 

2.2 Server conformance 

In order to conform to the present document a server shall support the following services as follows: 



• 



• 



Receiving the Start Application Session service and all of the mandatory aspects of this service as specified in 
clause 4. 

Receiving the Stop Application Session service and all of the mandatory aspects of this service as specified in 
clause 4. 

Receiving the Reset Application Session service and all of the mandatory aspects of this service as specified in 
clause 4. 

Sending the Application Session Terminated service and all of the mandatory aspects of this service as 
specified in clause 4. 

Send and receive XML Instance documents according to the XML Schema specified in clause 5 in the present 
document for the services listed in item 1 . 



References 



ECMA-269: "Services for Computer Supported Telecommunications Applications (CSTA) Phase III," 

6th edition. (June 2004). 

ECMA-323: "XML Protocol for Computer Supported Telecommunications Applications (CSTA) Phase III," 

3rd edition. (June 2004). 

ISO/IEC 8649: "Information technology - Open Systems Interconnection - Service definition for the Association 
Control Service Element" (1996). (This corresponds to ITU-T Recommendation X.217 1995). 
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Service definitions 



4.1 Start Application Session 

The Start Application Session service is used to initiate an application session between an application and a server. 

A globally unique identifier, called a sessionID, is returned in the positive service response that identifies the 
application session. 

Once an application session is established, the server must maintain information associated with the application session. 
When the application session is terminated, the application context information is cleared. 

The application session exists until: 

• it is stopped by using a Stop Application Session service; 

• the session is abnormally terminated by the server as indicated by the Application Session Terminated service 
(e.g. due to the session timer expiry); 

• etc. 



4.1.1 Service Request 



Table 4.1 : Start Application Session - Service Request 



Parameter Name 


Type 


M/O 


Description 


applicationlnfo 


Sequence 


M 


Specifies information associated with the application requesting 
the application session. This information consists of: 

• applications (M) - a character string that identifies the 
application requesting the application association. 

• applicationSpecificlnfo (0) - this consists of a list of one 
or more implementation specific attributes associated 
with the application requesting the application 
association. 


requestedProtocolVersions 


List of 

character 

strings 


M 


Specifies one or more application protocol versions that the 

application wishes to use for the application association. The list 

is ordered by highest priority protocol version first. 

The server shall choose the highest priority protocol version that 

it supports and return the chosen protocol version in the positive 

response. 

The character string specifying a specific protocol must be a 

globally unique string (e.g. a standardized namespace (URI) that 

indicates a given protocol version). 


requestedSessionDuration 


Value 





Specifies the length of time (in seconds) that the application 

session should be maintained. The sessionDuration timer can be 

periodically refreshed via the Reset Application Session Timer 

service. 

If the requestedSessionDuration is not provided the server will 

choose a default sessionDuration value. 


extensions 


Sequence 





Specifies non-standardized information. 
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4.1.2 Service response 



4.1.2.1 



Positive acknowledgement 



Table 4.2: Start Application Session - Positive Service Response 



Parameter Name 


Type 


M/O 


Description 


sessionID 


Character 
String 


M 


Specifies the globally unique identifier associated with the 
application session that has been created. 


actualProtocolVersion 


Character 
String 


M 


Specifies the protocol version that is being used for the 
application session. This protocol version shall be one of the 
protocol versions specified in the service request. 


actualSessionDuration 


Value 


M 


Specifies the value for the length of time (in seconds) that the 

application session will be maintained by the server. 

This value may be less than or equal to the 

requestedSessionDuration in the service request. 

If the requestedSessionDuration is not provided in the service 

request, the server shall provide a default value which shall be 

used for the application session. 


extensions 


Sequence 





Specifies non-standardized information. 



4.1.2.2 



Negative acknowledgement 



Table 4.3: Start Application Session - Negative Service Response 



Parameter 
Name 


Type 


M/O 


Description 


errorCode 


Character 
String 


M 


Specifies the type of error. 

Either a standardized error or an application specific error may be used. The 

standardized set of errors are: 

• invalidApplicationlnfo - the server is unable to establish an application 
session due to invalid or unrecognized information in the 
applicationlnfo parameter. 

• requestedProtocolVersionNotSupported - none of the requested 
protocol versions specified in the service request are supported. 

• serverResourcesBusy - the server cannot establish an application 
session due to internal resource constraints. 

• maxNumberSessions - the server cannot create an application 
session because it has reached the maximum number of allowed 
application sessions (e.g. license/provisioning limitations). 


extensions 


Sequence 





Specifies non-standardized information. 



4.1.3 Functional requirements 

1) The sessionID returned in the response is used in other ECMA Application Session services to manage the 
application session. 

2) The positive response includes the actual value of the sessionDuration used for the specified application 
session. This value may be less than what the application requested in the service request. 

3) For an existing session, an application can restart the sessionDuration timer by using the Reset Application 
Session Timer service. 

4) Once the sessionDuration timer expires the server shall terminate the application session and clear any 
application context information associated with the application session. 

5) Mechanisms defined outside of the present document may be used to authenticate a user before an application 
session is started. 
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4.2 Stop Application Session 



The Stop Application Session service is used by the application to terminate an existing application session. 



4.2.1 Service Request 



Table 4.4: Stop Application Session - Service Request 



Parameter Name 


Type 


M/O 


Description 


sessionID 


Character 
String 


M 


Specifies the globally unique identifier associated with the 
application session that is being stopped. 


sessionEndReason 


Character 
String 





Specifies the reason that the application session is being 

stopped. 

Either a standardized reason or an application specific reason 

may be used. The standardized set of reasons are: 

• normal - the application is no longer interested in 
maintaining this application association. 


extensions 


Sequence 





Specifies non-standardized information. 



4.2.2 Service Response 

4.2.2.1 Positive Acknowledgement 

Table 4.5: Stop Application Session - Positive Service Response 



Parameter Name 


Type 


M/O 


Description 


extensions 


Sequence 





Specifies non-standardized information. 



4.2.2.2 Negative Acknowledgement 

Table 4.6: Stop Application Session - Negative Service Response 



Parameter 
Name 


Type 


M/O 


Description 


errorCode 


Character 
String 


M 


Specifies the type of error. 

Either a standardized error or an application specific error may be 

used. The standardized set of errors are: 

• invalidSessionID - the sessionID is not valid or known by 
the server. 


extensions 


Sequence 





Specifies non-standardized information. 



4.2.3 Functional Requirements 



If the server does not recognize the sessionID in the service request it shall provide a negative service response with the 
error code "invalidSessionID". 
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4.3 Reset Application Session Timer 

The Reset Application Session Timer service is used by the application to reset the duration that an existing application 
session should be maintained. 

4.3.1 Service Request 

Table 4.7: Reset Application Session Timer - Service Request 



Parameter Name 


Type 


M/O 


Description 


sessionID 


Character 
String 


M 


Specifies the globally unique identifier associated with the 
application session whose timer is being reset. 


requestedSessionDuration 


Value 


O 


Specifies the new value for the length of time (in seconds) that 
the application requests that the server maintain the application 
session. 


extensions 


Sequence 


O 


Specifies non-standardized information. 



4.3.2 Service Response 

4.3.2.1 Positive Acknowledgement 

Table 4.8: Reset Application Session Timer - Positive Service Response 



Parameter Name 


Type 


M/O 


Description 


actualSessionDuration 


Value 


M 


Specifies the new value for the length of time (in seconds) that 
the application session will be maintained by the server. 
This value may be less than or equal to the 
requestedSessionDuration in the service request. 
If the requestedSessionDuration is not provided in the service 
request, the server shall provide a default value which shall be 
used for the application session. 


extensions 


Sequence 


O 


Specifies non-standardized information. 



4.3.2.2 



Negative Acknowledgement 

Table 4.9: Reset Application Session Timer - Negative Service Response 



Parameter 
Name 


Type 


M/O 


Description 


errorCode 


Character 
String 


M 


Specifies the type of error. 

Either a standardized error or an application specific error may be used. The 

standardized set of errors are: 

• invalidSessionID - the sessionID is not valid or known by the server. 

• serverCannotResetSessionDuration - the server cannot reset the 
session timer associated with the application session. 


extensions 


Sequence 


O 


Specifies non-standardized information. 



4.3.3 Functional Requirements 

A positive response to the service request indicates that the server has reset the session timer associated with 
the specified application session. 

The positive response includes the actual value of the sessionTimer used for the specified application session. 
This value may be less than what the application requested in the service request. 
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4.4 Application Session Terminated 

The Application Session Terminated service is sent by a server when the server has terminated an application session. 

4.4.1 Service Request 

Table 4.10: Application Session Terminated - Service Request 



Parameter Name 


Type 


M/O 


Description 


sessionID 


Character 
String 


M 


Specifies globally unique identifier associated with the application 
session that is being terminated. 


sessionEndReason 


Character 
String 


M 


Specifies the reason that the application session has been 

terminated. 

Either a standardized reason or an application specific reason 

may be specified. The standardized set of reasons are: 

• resourceLimitation - application session terminated due 
to resource constraints. 

• sessionTimerExpired - application session terminated 
due to the sessionTimer expiry. 


extensions 


Sequence 


O 


Specifies non-standardized information. 



4.4.2 Service Response 

There is no acknowledgement to this service request. 

4.4.3 Functional Requirements 

When the server terminates an application session, it clears all of the application context information associated with the 
application session. 
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5 Schema definitions 

5.1 Start Application Session 

<?xml version="l . 0" encoding="UTF-8 " ?> 

<xsd: schema tar get Name space="http : //www. ecma- inter national . org/ standards /ecma-3 54 /appl_session" 

xmlns : tns="http: //www. ecma. ch/standards/ecma-354/csta" 

xmlns : xsd="http: //www. w3 . org/200 1/XMLSchema" elementFormDef ault=" qualified" 

at t r ibut eFormDe f ault=" unqualified "> 

<xsd: annotation> 

<xsd: document at ion>Ecma- St art -Appli cat ion- Session</xsd: document at ion> 
</xsd: annotation> 

<xsd: element name="StartApplicationSession"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="applicationInf o"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="applicationID" type="xsd: string" /> 
<xsd: element name="applicationSpeci fie Info" minOccurs="0 "> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: any namespace="##any" maxOccur s= "unbounded" /> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="requestedProtocolVersions "> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="protocolVersion" type="xsd: string" 
maxOccurs="unbounded" /> 

</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="requestedSessionDuration" type="xsd: integer" minOccurs="0 " /> 
<xsd: element name=" extensions" minOccurs="0 "> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: any namespace="##any " maxOccur s= "unbounded" /> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="StartApplicationSessionPosResponse"> 
<xsd : complexType> 
<xsd: sequence> 

<xsd: element name="sessionID" type="xsd: string" /> 
<xsd: element name="actualProtocolVersion" type="xsd: string" /> 
<xsd: element name= " actual SessionDur at ion" type="xsd: integer " /> 
<xsd: element name=" extensions " minOccurs="0 "> 
<xsd : complexType> 
<xsd: sequence> 

<xsd: any namespace="##any " maxOccur s= "unbounded" /> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="StartApplicationSessionNegResponse"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="errorCode"> 
<xsd: complexType> 
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<xsd: choice> 

<xsd: element name="def inedError "> 
<xsd: simpleType> 

<xsd: restriction base="xsd: string"> 

<xsd: enumeration value="invalidApplicat ion Info" /> 
<xsd: enumeration 
value="requestedProtocolVersionNot Supported" /> 

<xsd: enumeration value="serverResourcesBusy " /> 
<xsd: enumeration value="maxNumberSessions " /> 
</xsd:restriction> 
</xsd: simpleType> 
</xsd: element> 

<xsd: element name="applError " type="xsd: string" /> 
</xsd: choice> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name=" extensions" minOccurs="0"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: any namespace="##any " maxOccurs= "unbounded" /> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element > 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

</xsd: schema> 



5.2 Stop Application Session 



<?xml version=" 1.0" encoding="UTF-8 " ?> 

<xsd: schema tar get Name space="http : //www. ecma- inter national . org/ standards /ecma-354/appl_sessi on" 

xmlns : xsd="http: //www. w3 . org/200 1/XMLSchema" 

elementFormDef ault=" qualified" at t r ibut eFormDe f ault=" unqualified "> 

<xsd: annotation> 

<xsd: document at ion>Ecma-Stop-Applicat ion- Session</xsd: document at ion> 
</xsd: annotation> 

<xsd: element name="StopApplicationSession"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="sessionID" type="xsd: string" /> 
<xsd: element name="sessionEndReason"> 
<xsd: complexType> 
<xsd: choice> 

<xsd: element name="def inedEndReason"> 
<xsd: simpleType> 

<xsd: restriction base="xsd: string" > 
<xsd: enumeration value= "normal" /> 
</xsd:restriction> 
</xsd: s imp le Type > 
</xsd: element> 

<xsd: element name="appEndReason" type="xsd: string" /> 
</xsd: choice> 
</xsd: complexType> 
</xsd: element > 

<xsd: element name=" extensions" minOccurs="0 "> 
<xsd : complexType> 
<xsd: sequence> 

<xsd: any namespace="##any " maxOccurs= "unbounded" /> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="StopApplicationSessionPosResponse"> 
<xsd : complexType> 
<xsd: sequence> 

<xsd: element name=" extensions" minOccurs="0 "> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: any namespace="##any " maxOccurs=" unbounded" /> 
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</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="StopApplicationSessionNegResponse"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="errorCode"> 
<xsd: complexType> 
<xsd: choice> 

<xsd: element name="def inedError "> 
<xsd: simpleType> 

<xsd: restriction base="xsd: string"> 

<xsd: enumeration value="invalidSessionID"/> 
</xsd: restriction> 
</xsd: simpleType> 
</xsd: element> 

<xsd:element name="applError" type="xsd: string"/> 
</xsd: choice> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name="extensions" minOccurs="0"> 
<xsd : complexType> 
<xsd: sequence> 

<xsd:any namespace="##any" maxOccurs="unbounded"/> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

</xsd: schema> 

5.3 Reset Application Session Timer 

<?xml version="l . 0" encoding="UTF-8"?> 

<xsd: schema targetNamespace="http: //www. ecma- international . org/standards/ecma-354/appl_session" 

xmlns : xsd="http: //www. w3 . org/200 1/XMLSchema" elementFormDefault=" qualified" 

at t r ibut eFormDe f ault=" unqualified "> 

<xsd: annotation> 

<xsd: document at ion>Ecma-Reset-Appli cat ion- Sess ion-Timer </xsd: document at ion> 
</xsd: annotation> 

<xsd: element name="ResetApplicationSessionTimer "> 
<xsd: complexType> 
<xsd: sequence> 

<xsd:element name="sessionID" type="xsd: string"/> 

<xsd:element name="requestedSessionDuration" type="xsd: integer" minOccurs="0"/> 
<xsd:element name="extensions" minOccurs="0"> 
<xsd: complexType> 
<xsd: sequence) 

<xsd:any namespace="##any" maxOccurs="unbounded"/> 
</xsd: sequence) 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

<xsd: element name= "Reset ApplicationSessionTimerPosResponse"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="actualSessionDuration" type="xsd: integer " /> 
<xsd:element name="extensions" minOccurs="0"> 
<xsd: complexType> 
<xsd: sequence) 

<xsd:any namespace="##any" maxOccurs="unbounded"/> 
</xsd: sequence) 
</xsd: complexType> 
</xsd: element> 
</xsd: sequence> 
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</xsd: complexType> 
</xsd: element > 

<xsd: element name="ResetApplicationSessionTimerNegResponse"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd: element name="errorCode"> 
<xsd: complexType> 
<xsd: choice> 

<xsd: element name="def inedError "> 
<xsd: simpleType> 

<xsd: restriction base="xsd: string"> 

<xsd: enumeration value="invalidSessionID"/> 
<xsd: enumeration value="serverCannotResetSessionTimer"/> 
</xsd: restriction> 
</xsd: simpleType> 
</xsd: element> 

<xsd:element name="applError" type="xsd: string"/> 
</xsd: choice> 
</xsd: complexType> 
</xsd: element> 

<xsd:element name="extensions" minOccurs="0"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd:any namespace="##any" maxOccurs="unbounded"/> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element > 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

</xsd: schema> 

5.4 Application Session Terminated 

<?xml version="l . 0" encoding="UTF-8 " ?> 

<xsd: schema tar get Name space="http : //www. ecma- inter national . org/standards/ecma-354/appl_session" 

xmlns :xsd="http: //www. w3 . org/2001 /XMLSchema" 

e lementFormDe fault =" qualified" attributeFormDefault="unqualif ied"> 

<xsd: annotation> 

<xsd: document at ion>Ecma-Applicat ion- Session-Terminated</xsd: document at ion> 
</xsd: annotation> 

<xsd: element name="ApplicationSessionTerminated"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd:element name="sessionID" type="xsd: string"/> 
<xsd: element name="sessionTermReason"> 
<xsd: complexType> 
<xsd: choice> 

<xsd: element name="def inedTermReason"> 
<xsd: simpleType> 

<xsd: restriction base="xsd: string"> 

<xsd: enumeration value="resourceLimitation" /> 
<xsd: enumeration value="sessionTimerExpired" /> 
</xsd: restriction> 
</xsd: simpleType> 
</xsd: element > 

<xsd:element name="serverTermReason" type="xsd: string"/> 
</xsd: choice> 
</xsd: complexType> 
</xsd: element> 

<xsd:element name="extensions" minOccurs="0"> 
<xsd: complexType> 
<xsd: sequence> 

<xsd:any namespace="##any" maxOccurs="unbounded"/> 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element > 
</xsd: sequence> 
</xsd: complexType> 
</xsd: element> 

</xsd: schema> 
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Annex A (informative): 
Examples 

This annex illustrates the use of the Ecma Application Session Services for ECMA-323. 

A.1 Starting an Application Session 

This clause illustrates examples of how an application session can be started. 

A. 1.1 Basic Example 

In this example, an application uses the Start Application Session service to start an application session. 

In this example: 

The application name is "CSTA Example App". 

The requested application protocol is: 
http://www.ecma-international.org/standards/ecma-323/csta/ed3 . 

The requested session duration is specified at 300 seconds. If the application does not send a Reset Application Session 
Timer within 300 seconds, the application session will be terminated. 

<?xml version=" 1 . " encoding="UTF-8"?> 

<StartApplicationSession xmlns="http: //www. ecma- international . org/standards/ecma-35 4/appl_session" 

xmlns :xsi="http: //www. w3 . org/2001 /XMLSchema-instance"> 

<applicationInf o> 

<applicationID>CSTA Example App</applicationID> 

</applicationInf o> 

<requestedProtocolVersions> 

<protocolVersion>http: //www. ecma- international . org/standards/ecma-323/csta/ed3</protocolVersion> 

</requestedProtocolVersions> 

<requestedSessionDuration>300</requestedSessionDuration> 
</StartApplicationSession> 

The following example shows the positive response message that the application receives based upon the previous 
request message. 

The response includes: 

A sessionID used to identify the session. 

The actual application protocol version used for this session. Since the application specified only one application 
protocol in the request, it is the only possible application protocol that the server could choose. 

The actual session duration used by the server. This is the same as the value requested by the application. 

<?xml version="l . 0" encoding="UTF-8 " ?> 

<StartApplicationSessionPosResponse 

xmlns="http : //www. ecma- inter national . org/standards/ecma-354/appl_session" 

xmlns : xsi="http : //www. w3 . org/200 l/XMLSchema-instance"> 

<sessionID>AEF12111212</sessionID> 

<actualProtocolVersion>http : //www. ecma- international . org/ standards /ecma- 3 2 3/csta/ed3 

</actualProtocolVersion> 

<actualSessionDuration>300</actualSessionDuration> 
</StartApplicationSessionPosResponse> 
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A. 1.2 Application Protocol Negotiation 

This example illustrates how an application can specify several versions of CSTA protocols that it can support. The 
response message indicates the highest priority version that the server supports which is the application protocol used 
for the application session. 

In this example: 

The application includes the namespace associated with the three ECMA-323 protocol versions. The first protocol 
version in the list is the highest priority from the application perspective. The server should choose the highest priority 
version from the list of requestedProtocol Versions that it can support. 

<?xml version="l . 0" encoding="UTF-8"?> 

<StartApplicationSession xmlns="http : //www . ecma- international . org/standards/ecma-354/appl_session" 
xmlns : xsi = "http: //www. w3 . org/200 1 /XMLS enema- ins tance"> 
<applicationInf o> 

<applicationID>CSTA Example App</applicationID> 
</applicationInfo> 
<requestedProtocolVersions> 

<protocolVersion>http: //www. ecma- international . org/standards/ecma-323/csta/ed3 
</protocolVersion> 

<protocolVersion>http : //www. ecma . ch/standards/ecma-323/csta/ed2 
</protocolVersion> 

<protocolVersion>http : //www. ecma . ch/standards/ecma-323/csta 
</protocolVersion> 

</requestedProtocolVersions> 

<requestedSessionDuration>300</requestedSessionDuration> 
</StartApplicationSession> 

The following example shows the response message that the application receives based upon the previous request 
message. 

The response includes: 

The actual application protocol version used for this session. Of the three requested application protocols in the request, 
the highest priority application protocol that the server supports is the one associated with the ECMA-323 2 nd Edition. 
This is the application protocol chosen for this application session and it is returned in the response as shown below. 



<?xml version="l . 0" encoding="UTF-8"?> 

<StartApplicationSessionPosResponse 

xmlns="http: //www. ecma- international . org/standards/ecma-35 4/appl_session" 

xmlns : xsi = "http: //www. w3 . org/200 1 /XMLS enema- ins tance"> 

<sessionID>AEF12111212</sessionID> 

<actualProtocolVersion>http: //www. ecma. ch/standards/ecma-323/csta/ed2 
</actualProtocolVersion> 

<actualSessionDuration>300</actualSessionDuration> 
</StartApplicationSessionPosResponse> 

A.1 .3 Vendor Specific Application Information 

This example illustrates how an application can provide additional application information in the service request. 

In this example: 

The application provides two additional vendor specific elements needed to identify this particular application: a userlD 
and a password. These two elements are defined in another schema namespace referenced as vendorData in the 
following example. 
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<?xml version="l . 0" encoding="UTF-8 " ?> 

<StartApplicationSession xmlns="http : //www . ecma- international . org/standards/ecma-354/appl_session" 
xmlns :xsi="http: //www. w3 . org/200 1/XMLSchema- instance" 
xmlns : vendorData="http: //www. vendor name /product /release "> 
<applicationInf o> 

<applicationID>CSTA App 22343</applicationID> 
<applicationSpecif icInfo> 

<vendorData : userID>userName</vendorData : userID> 
<vendorData:password>defaultPassword</vendorData:password> 
</applicationSpecif iclnf o> 
</applicationInfo> 
<requestedProtocolVersions> 

<protocolVersion>http: //www. ecma- international . org/standards/ecma-323/csta/ed3</protocolVersion> 
</requestedProtocolVersions> 

<requestedSessionDuration>300</requestedSessionDuration> 
</StartApplicationSession> 



A.2 Stopping an Application Session 

In this example, an application uses the Stop Application Session service to request to stop an application session. 

<?xml version="l . 0" encoding="UTF-8 " ?> 

<StopApplicationSession xmlns="http : //www. ecma- inter national . org/standards/ecma-354/appl_session" 

xmlns :xsi="http: //www. w3 . org/200 l/XMLSchema-instance"> 

<sessionID>AEF12111212</sessionID> 

<sessionEndReason> 

<def inedEndReason>normal</def inedEndReason> 

</sessionEndReason> 
</StopApplicationSession> 

The following example shows the response message that the application receives based upon the previous request 
message. 

<?xml version="l . 0" encoding="UTF-8"?> 

<StopApplicationSessionPosResponse 

xmlns="http : //www. ecma- international . org/ standards /ecma- 354 /app l_sessi on" 

xmlns : xsi="http : //www. w3 . org/2001 /XMLSchema-instance" /> 



A. 3 Resetting an Application Session Timer 

This clause illustrates how an application session timer is reset by an application. 

<?xml version=" 1 . " encoding="UTF-8"?> 

<ResetApplicationSessionTimer 

xmlns="http : //www. ecma- inter national . org/standards/ecma-354/appl_session" 

xmlns :xsi="http: //www. w3 . org/2001 /XMLSchema-instance "> 

<sessionID>AEF12111212</sessionID> 

<requestedSessionDuration>500</requestedSessionDuration> 
</ResetApplicationSessionTimer> 

The following example shows the response message that the application receives based upon the previous request 
message. 

<?xml version="l . 0" encoding="UTF-8"?> 

<ResetApplicationSessionTimerPosResponse 

xmlns="http : //www. ecma- international . org/standards/ecma-354/appl_session" 

xmlns :xsi="http: //www. w3 . org/2001 /XMLSchema-instance "> 

<actualSessionDuration>500</actualSessionDuration> 
</ResetApplicationSessionTimerPosResponse> 
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A.4 Application Session Terminated 

This clause illustrates how a server indicates that application session has been terminated. The server indicates that the 
reason the application session was terminated was because the session timer expired. 

<?xml version="l . 0" encoding="UTF-8 " ?> 

<ApplicationSessionTerminated 

xmlns="http : //www. ecma- international . org/standards/ecma-354/appl_session" 

xmlns : xsi="http: //www. w3 . org/200 l/XMLSchema-instance"> 

<sessionID>AEF12111212</sessionID> 

<sessionTermReason> 

<def inedTermReason>sessionTimerExpired</def inedTermReason> 

</sessionTermReason> 
</ApplicationSessionTerminated> 
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Annex B (informative): 
CSTA usage notes 

This clause lists considerations when using the present document with CSTA protocols such as ECMA-323. 

For CSTA protocols, the information associated with an application session (i.e. application context) consists of CSTA 
monitors and CSTA registrations established within the application session. When the application session is stopped, 
these CSTA monitors and registrations are released. 

For the CSTA Protocols, the CSTA System Status services can be used to provide status related to an application 
session state. For example: 

• The CSTA System Status ("enabled") service clears monitors and registrations associated with an application 
session without terminating the application session. 

• The CSTA System Status ("messagesLost") service indicates that messages associated with an application 
session may have been lost. 

• The CSTA Query System Status service can be used to obtain the system status related to the application 
session. 

The sessionID may be transported as part of the header information associated with application messages. When SOAP 
is used, the sessionID should be included in the SOAP header for each application message exchanged over the 
application session. The recipient (application or server) of the application message should verify that the sessionID is 
valid otherwise it should ignore the message. 

• For Web Services (e.g. CSTA XML with SOAP over HTTP), the sessionDuration expiry should be used to 
detect when an (e.g. CSTA Web Client) application is no longer present. The (e.g. CSTA Web) Server should 
tear down the application session after the time specified by sessionDuration (unless reset by the Reset 
Application Session Timer service). 
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